home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
EnigmA Amiga Run 1995 November
/
EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso
/
earcd
/
program
/
gcc
/
gcc270-d.lha
/
gnu
/
man
/
cat3
/
getc.0
< prev
next >
Wrap
Text File
|
1992-08-10
|
2KB
|
67 lines
GETC(3) UNIX Programmer's Manual GETC(3)
NNAAMMEE
ffggeettcc, ggeettcc, ggeettcchhaarr, ggeettww - get next character or word from input stream
SSYYNNOOPPSSIISS
##iinncclluuddee <<ssttddiioo..hh>>
_i_n_t
ffggeettcc(_F_I_L_E _*_s_t_r_e_a_m)
_i_n_t
ggeettcc(_F_I_L_E _*_s_t_r_e_a_m)
_i_n_t
ggeettcchhaarr()
_i_n_t
ggeettww(_F_I_L_E _*_s_t_r_e_a_m)
DDEESSCCRRIIPPTTIIOONN
The ffggeettcc() function obtains the next input character (if present) from
the stream pointed at by _s_t_r_e_a_m, or the next character pushed back on the
stream via ungetc.
The ggeettcc() function acts essentially identically to ffggeettcc(), but is a
macro that expands inline.
The ggeettcchhaarr() function is equivalent to: getc with the argument stdin.
The ggeettww() function obtains the next _i_n_t (if present) from the stream
pointed at by _s_t_r_e_a_m.
RREETTUURRNN VVAALLUUEESS
If successful, these routines return the next requested object from the
_s_t_r_e_a_m. If the stream is at endoffile or a read error occurs, the rou
tines return EOF. The routines feof(3) and ferror(3) must be used to dis
tinguish between endoffile and error. If an error occurs, the global
variable _e_r_r_n_o is set to indicate the error. The endoffile condition
is remembered, even on a terminal, and all subsequent attempts to read
will return EOF until the condition is cleared with clearerr.
SSEEEE AALLSSOO
ferror(3), fread(3), fopen(3), putc(3), ungetc(3)
SSTTAANNDDAARRDDSS
The ffggeettcc(), ggeettcc() and ggeettcchhaarr() functions conform to ANSI C3.1591989
(``ANSI C'').
BBUUGGSS
Since EOF is a valid integer value, feof and ferror must be used to check
for failure after calling ggeettww(). The size and byte order of an _i_n_t
varies from one machine to another, and ggeettww() is not recommended for
portable applications.
BSD Experimental June 29, 1991 1